docs: branch strategy + main consolidation runbook - #10
Closed
ihistand wants to merge 1 commit into
Closed
Conversation
Captures the long-term branch layout for sqlanvil and the runbook for consolidating the postgres-first-class PR stack onto main. Decisions: - main stays sqlanvil's source of truth (already diverged from upstream — no value in preserving pristine fork) - Add an upstream-main mirror branch for occasional cherry-picks from dataform-co/dataform/main - Apply branch protection (force-push + deletion only — skip required reviews + status checks for now since solo dev and no CI yet) - Consolidate the 9-PR stack only after each PR has been reviewed and merged into restore-postgres-adapter individually Includes: - Path A (recommended, simpler) vs Path B (rename main) comparison - Timing — consolidate after stack lands, not during - Branch protection table (what to enable now vs later) - Upstream sync cadence (quarterly fetch, cherry-pick if worth it, otherwise skip — upstream activity is very low) - PR branch naming conventions (already in use across the stack) - Action items checklist for the consolidation
Collaborator
Author
|
Superseded: the Postgres reintegration + Dataform→SQLAnvil rename landed on |
ihistand
added a commit
that referenced
this pull request
Jul 21, 2026
…a post_operations) Mirrors the agent-skills SKILL.md update: delta #10 expanded with the AI/BI framing (descriptions/columns persist as catalog comments, join targets named in column descriptions, PK/FK via post_operations with NOT ENFORCED on BigQuery targets, uniqueKey/uniqueKeys exclusivity, catalog artifacts, guide link); delta #9 covers FKs; delta #11 NOT-ENFORCED flag scoped. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W86VUf4ptKnmhxWoqgA7gb
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Captures the long-term branch layout for sqlanvil + the runbook for consolidating the postgres-first-class PR stack onto `main`. Lives at `docs/branch_strategy.md`.
Decisions captured
Contents
Independent of code stack
This is a planning doc. No code changes. Can merge any time; doesn't block the postgres-first-class PR stack or the docs site plan PR.
Test plan
🤖 Generated with Claude Code